home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / PROGRAMM / PASCAL / 0191.ZIP / PGM-AIDE.DOC < prev    next >
Text File  |  1985-11-10  |  8KB  |  148 lines
  1.                  DOCUMENTATION FOR PROGRAM AIDE
  2.                          by Lynn Canning
  3.                      
  4. Credits:
  5.   Program Aide utilizes a number of modules that were written
  6.   by several people and then placed in the public domain.  Please note
  7.   the copyright and use information at the beginning of the modules.
  8.  
  9.   STAYRES.320 is a skeleton program from which the memory resident version
  10.   of Program Aide was created.  It was written by Lane Ferris, 4268 26th St,
  11.                                                   San Francisco, Ca 94131.
  12.  
  13.   WINDO.INC was originally written by Michael A. Covington, address unknown.
  14.   It was modified by Lane Ferris for use in the STAYRES demo program.  It
  15.   was further modified by Lynn Canning to add additional features.  It can
  16.   now be included in any application requiring windows.
  17.   (See the documentation at the beginning of the module).
  18.  
  19.   SC.INC and PGM-AIDE.COM were written by, Lynn Canning, 9107 Grandview,
  20.                                            Overland Park, Ks. 66212
  21.                                            913-649-7334.
  22.  
  23.   EP.INC was written by Lynn Canning and Karson W. Morrison
  24.                                          RD 1, Box 531
  25.                                          Ringoes, NJ 08551
  26.  
  27. This program was distributed in a library type file which should have
  28. included the following modules:
  29.  
  30. PGM-AIDE.COM  -  The memory resident version of Program Aide.
  31. PGM-AIDE.PAS  -  Turbo Pascal source code for the above.
  32. PGM-AIDE.DVR  -  Include file for the PGM_AIDE driver.
  33. SC.INC        -  Include file for Screen Counter.
  34. WINDO.INC     -  Include file for window routines.
  35. EP.COM        -  Include file for Epson Printer.
  36. PGM_AIDE      -  Documentation file for the above.
  37.  
  38. Installation:
  39.  
  40. Program Aide can be executed from DOS and will become memory resident.
  41. It can then be popped up when executing most programs.  Problems may 
  42. result if other memory resident programs have previously been called.  
  43. It is therefore suggested that Program Aide be called before other 
  44. memory resident programs.  This seems to eliminate the problem.  I have 
  45. popped up a memory resident program and then popped Program Aide right 
  46. over the top of it with no problems.  Program Aide is popped up by 
  47. typing Alt-F1 after it is installed.
  48.  
  49. SC.INC is the include module for SCREEN COUNTER.  A stand alone version 
  50. of SCREEN COUNTER can be compiled from SC.INC by changing the last (end;) 
  51. in the source to (end.) and inserting the line {$I WINDO.INC } on the 
  52. first line.  Rename SC.INC to SC.PAS.
  53.  
  54.  
  55. EP.INC is the include module for EPSON PRINTER.  A stand alone version 
  56. of EPSON PRINTER can be compiled from EP.INC by changing the last (end;) 
  57. in the source to (end.) and inserting the line {$I WINDO.INC } on the 
  58. first line.  Rename EP.INC to EP.PAS.
  59.  
  60.  
  61.  
  62. Program Documentation:
  63.  
  64. I am not particularly familiar with the code in the resident module
  65. I therefore refer you to the documentation included in the modules 
  66. source code.  This was written by the original author and will have 
  67. to stand on its own.
  68.  
  69. Program Documentation for SC.INC:
  70.  
  71. Screen Counter was written to count screen positions.  When Screen Counter
  72. is activated you will notice four counters on the last line of the screen.
  73. The line counter obviously tells you what line you are on and correspondingly
  74. the column counter gives you the column or your position on the line.  The
  75. trip counters is used to determine the horizontal and vertical distance
  76. between two points on the screen.  Note that the column and line counters
  77. correspond to the X and Y screen coordinates respectively.  These counters can
  78. therefore be used to determine the screen coordinates when needed in a program
  79. such as dBaseII or when writing window programs.
  80.  
  81. To use the trip counters, place the cursor on the leftmost point of
  82. where you wish to begin counting.  Hit the F2 key to reset the counters to 1.
  83. Move the cursor to the rightmost point.  The htrip counter now contains the
  84. horizontal distance between the two points including the starting and ending
  85. positions.  The vtrip counter can be used to count lines or vertical distance.
  86.  
  87. There are of course limitations on the use of the trip counters.  The
  88. counters reset to the value of the column and line counters if you attempt to
  89. drive them to a negative value by moving left or up.  The counters count
  90. from left to right and top to bottom.  If you overshoot your target position,
  91. you can move the cursor to the right or up and the counters will decrement.
  92.  
  93. Cursor movement is controlled by the number pad keys.  For details, see the
  94. on-screen help menu by pressing the F1 key when in the program.  The cursor
  95. will screen wrap except when attempting to go left at line 1 column 1 or
  96. right at line 24 column 80.
  97.  
  98. Program Documentation for EP.INC:
  99.  
  100. This program is mostly self explanatory.  Various print options for an
  101. Epson printer are turned on an off through the use of a menu.  When the
  102. program is called, the printer is reset to its power up state.  Various
  103. options can then be set by hitting the corresponding number or letter.
  104. Options previouly set can be turned off by hitting the number or letter
  105. key again.  Some options are incompatible with other options (see the 
  106. printer manual for Elite mode).  After the options are set, you can see
  107. the results by printing a test pattern.  This pattern also specifies the
  108. options set.  Try option "K" for printing program listings.
  109.  
  110. Program Documentation for WINDO.INC:
  111.  
  112. This program creates windows by utilizing user specified parameters.  The
  113. options include setting foreground and background colors and the type of
  114. borders desired.  Complete documentation for this program is included in
  115. the module.  This module is completely transportable and can be utilizied
  116. in other programs requiring windows.  A time delay procedure is included
  117. which will suspend program operation for a specified number of seconds.
  118. Use of this routine instead of the Turbo delay command will allow your
  119. program to be transportable between systems with different clock speeds
  120. while still maintaining the same delay interval.
  121.  
  122.  
  123. Misc Documemtation:
  124.  
  125. The resident program will work with a color graphics card or a 
  126. momochrome monitor.  If you are using a composite monochrome monitor
  127. such as is found on the Compac and IBM portables or you are not using
  128. a color monitor with a color graphics card it may be necessary to change
  129. the color combinations within the source code to black and white.  There
  130. may be some problems when using a monochrome monitor.  I don't have a 
  131. monochrome monitor, so I haven't been able to determine if everything
  132. works properly.  If anyone comes up with a fix for a problem, please let
  133. me know so that I can include it in the module.
  134.  
  135. Additional utilities can be included by modifying PGM-AIDE.DVR as 
  136. appropriate and including the module in PGM-AIDE.PAS.  It is suggested
  137. that the additional module be tested as stand-alone then made it into an
  138. include file when it is completed.  This approach  will speed testing
  139. considerably.  Keep in mind that include files cannot be nested.
  140.  
  141. Program PGM-AIDE can be removed from memory by pressing CTRL-HOME keys.
  142. It must be remembered that if you remove a program from memory and you
  143. have anything loaded into memory after that program then you leave a 
  144. hole in memory and your machine may go bye-bye.  If you are going to
  145. remove PGM-AIDE you should do it from the DOS prompt, only if other
  146. resident programs have not been loaded into the machine after PGM-AIDE.
  147. If you think that you are going to be removing PGM-AIDE often then put
  148. it as the last program in your AUTOEXEC.BAT.